home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / dbill34.zip / DOORBILL.DOC < prev    next >
Text File  |  1991-02-22  |  22KB  |  551 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                  DOORBILL 3.4
  21.                                  ------------
  22.  
  23.                         One of the MicroNet Collection
  24.                         of Multi-BBS Doorware programs
  25.                             for systems supporting
  26.                        PCBOARD.SYS, USERS.SYS, DOOR.SYS,
  27.                    CALLINFO.BBS, SFDOORS.DAT or DORINFOx.DEF
  28.  
  29.                                       By
  30.  
  31.                                   Ted Freeman
  32.                                 P.O. Box 83401
  33.                             Oklahoma City, OK 73148
  34.  
  35.                              (C) Copyright 1990-91
  36.                               All Rights Reserved
  37.  
  38.  
  39.  
  40.  
  41. DOORBILL v3.4 - Users Guide - Page i
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                                 C O N T E N T S
  50.                                =================
  51.  
  52.         Warranty ............................................ 1
  53.  
  54.         Copyright notice .................................... 1
  55.  
  56.         Distribution ........................................ 1
  57.  
  58.         Description ......................................... 1
  59.  
  60.         Registration ........................................ 2
  61.  
  62.         DBUTIL .............................................. 3
  63.  
  64.           Categories (Add/Edit) ............................. 3
  65.  
  66.           Doors (Add/Edit) .................................. 4
  67.  
  68.           Post Bulletin ..................................... 5
  69.  
  70.           Sort Door Listings ................................ 5
  71.  
  72.         DoorBill Configuration Files ........................ 6
  73.  
  74.         Door Operation Information .......................... 7
  75.  
  76.         Miscellaneous Notes ................................. 8
  77.  
  78.         Order Form .......................................... 9
  79.  
  80.  
  81.  
  82. DOORBILL v3.4 - Users Guide - Page 1
  83.  
  84.  
  85.                                    WARRANTY
  86.                                    --------
  87.  
  88.     This product is provided "as is" without warranty of any kind. The entire
  89.     risk as to the results and  performance of the program is assumed by you.
  90.     Futhermore, the  author does  not warrant, guarantee, or  make any  other
  91.     representations regarding  the use of,  or the  results of the use of the
  92.     program,  and you  rely on the  program and  results  solely at  your own
  93.     risk.  The author  cannot and  will not accept  responsibility for system
  94.     damage, loss of profit, or any other special, consequential or incidental 
  95.     damages  resulting  from  the  use  or  inability  to  use this  product.
  96.  
  97.  
  98.                                    COPYRIGHT
  99.                                    ---------
  100.  
  101.     DOORBILL,  Copyright (c) 1990 by  Ted  Freeman, is being  distributed as
  102.     Shareware. Under this concept you may use the  SHAREWARE  (unregistered)
  103.     version for a reasonable period of  time for evaluation  after which you
  104.     must either register your copy or discontinue  usage.
  105.  
  106.  
  107.                                  DISTRIBUTION
  108.                                  ------------
  109.  
  110.     This program is being distributed via the SHAREWARE concept and as such,
  111.     may be copied freely with the following restrictions:
  112.  
  113.                 * The program must be supplied in it's original
  114.                   unmodified form, including documentation.
  115.  
  116.                 * DOORBILL may not be distributed as part of any
  117.                   commercial application or service without the
  118.                   express, written consent of the author.
  119.  
  120.                 * Vendors of Shareware/Public Domain software may
  121.                   not distribute this program without the express,
  122.                   written consent of the author, unless said Vendor
  123.                   has been approved by the Association of Shareware
  124.                   Professionals (ASP).
  125.  
  126.  
  127.                                   DESCRIPTION
  128.                                   -----------
  129.  
  130.     DOORBILL is a versatile Door manager that allows you to add or delete
  131.     Door programs to your BBS with relative ease. DOORBILL features many
  132.     options such as applying level restrictions to all Categories of Doors
  133.     as well as to each individual Door. In addition you may lock any Door
  134.     based solely on the caller's baud rate! DOORBILL options include the
  135.     viewing of your Doors/Games Bulletins online, running the included
  136.     utility program while the Sysop is in local mode, creating a Bulletin
  137.     listing of all your Door Categories and Doors available. You may add,
  138.     delete, move, sort, and insert Categories and Doors with just a couple
  139.     of keystrokes. DOORBILL is compatible with PCBoard v14.x, Wildcat!,
  140.     Spitfire, RBBS, QBBS, Remote Access, as well as those BBS systems
  141.     that utilize the standard 52-line DOOR.SYS file.
  142.  
  143.  
  144.  
  145. DOORBILL v3.4 - Users Guide - Page 2
  146.  
  147.  
  148.  
  149.                                  REGISTRATION
  150.                                  ------------
  151.  
  152.         DOORBILL represents many hours of programming and the author
  153.         deserves just compensation for his time, efforts and expertise.
  154.         If you find this program to be of some value and you continue
  155.         to use it on your BBS system, you must return the registration
  156.         form provided along with the registration fee. Registration
  157.         entitles you to free upgrades via modem from MicroNet's Support
  158.         Conference. Payments should be made in the form of a check or
  159.         money order (do NOT send cash!). Foreign orders must be in U.S.
  160.         funds drawn on a U.S. bank.
  161.  
  162.         Online registration with Visa or Mastercard is available via our
  163.         Credit Card Door on the following systems:
  164.  
  165.         MicroNet:  (405) 528-3175 HST      Livewire:  (609) 235-5297 MNP5
  166.           (OK)     (405) 528-8610                     (609) 866-2551 HST DS
  167.                    (405) 557-1103 ULTRA               (609) 727-3246 MNP5
  168.  
  169.                          -----------------------------
  170.  
  171.  
  172.  
  173. DOORBILL v3.4 - Users Guide - Page 3
  174.  
  175.                                   DBUTIL.EXE
  176.  
  177.                              Categories (Add/Edit)
  178.  
  179. DBUTIL.EXE is where you enter all data for your  doors.  It is  very  simple 
  180. to use  but we'll  take a walk through the prompts just to make sure. First, 
  181. we select "Categories (Add/Edit)". You may use the arrow keys or just type C.
  182.  
  183. Field 1: BBS DIR  [C:\PCB                   ]            <- Required Field
  184.  
  185.   Path to your default BBS directory.
  186.  
  187. Field 2: BLT Menu [C:\PCB\GAMES\BLT         ]            <- Optional Field
  188.  
  189.   Enter full Path/Filename for your DOORS BLT file (this is the menu of 
  190.   bulletins you create with The Draw or whatever). Both ASCII (BLT) and
  191.   ANSI graphics (BLTG) bulletins are supported but not PCBoard @X codes.
  192.   Leave this field blank to disable.
  193.  
  194. Field 3: BLT.LST  [C:\PCB\GAMES\BLT.LST     ]            <- Optional Field
  195.  
  196.   Enter the full Path/Filename for your DOOR/GAMES BLT.LST file. This file
  197.   must be compatible with the PCBoard BLT.LST format. This is a random 
  198.   access file with 30 byte fields for each entry. Leave blank to disable.
  199.  
  200. Field 4: BLT Path [C:\PCB\GEN\BLT1     ]                 <- Optional Field
  201.  
  202.   The BLT field is for those of you who wish to post a Bulletin of all
  203.   your Door Categories and their associated Doors. This filename must be
  204.   limited to 7 characters or less because a 'G' will be appended on the
  205.   ANSI bulletin. (See 'POST BULLETIN' q.v.)
  206.  
  207. Field 5: Auto-ANSI? [Y]
  208.  
  209.    This option toggles automatic ANSI detection. If this is on (default),
  210.    DoorBill will determine if the remote system has ANSI capabilities and
  211.    if so, will display the Menus using extended ASCII characters. If this
  212.    is set to 'N' or ANSI is not detected, the Menus use keyboard characters.
  213.    Whether color is displayed or not is determined by the BBS setting.
  214.  
  215. Field 6: HST [HST xxxxx ]                                <- Optional Field
  216.  
  217.   The HST field is for US Robotics HST owners that wish to run doors that
  218.   cannot  handle the high port speeds. DoorBill will switch the port speed
  219.   down to whatever the callers connect rate is (1200/2400 etc.). Valid
  220.   options  are HST 9600, HST 19200, HST 38400. If you don't have an HST or
  221.   don't want to use this option, just leave the field blank. Make sure this
  222.   agrees with your port speed in PCBSETUP or field 5 of DOOR.SYS.
  223.   NOTE: The S02 register on the HST must be set to 43 (S02=43)!
  224.  
  225. Lines 4 - 24:                                                LEVEL
  226. Title for Menu 1:  [Trivia and Word Games                 ]  [ 30]
  227. Title for Menu 2:  [Space and War Games                   ]  [100]
  228. Title for Menu 3:  [Miscellaneous                         ]  [ 50]  Etc.
  229.  
  230. DoorBill allows you to set a security level for each category. In the above
  231. example, a caller with level 50 would see only the 1st and 3rd entries 
  232. but for him they would be numbered 1 and 2. He will never be aware there is 
  233. another category there. A caller with level 100 would see all 3 entries.
  234. When the cursor is in one of the 20 Title or Level fields, F2 and F3 are 
  235. active for inserting and deleting entries.
  236.  
  237.  
  238.  
  239. DOORBILL v3.4 - Users Guide - Page 4
  240.  
  241.                                Doors (Add/Edit)
  242.                                ----------------
  243.  
  244. When you are done entering your Category Titles, just hit F1 and your
  245. data will be saved. You will now see a menu of the categories you just
  246. entered. The first entry will be highlighted. Just hit enter to select
  247. the highlighted item or use the arrow keys to move the highlighted bar.
  248. Using the example above, that would be Trivia and Word Games.
  249.  
  250. Now you will see "Enter Data for New Door" highlighted. Select this any 
  251. time you wish to add a new door.
  252.  
  253. Follow the example below and you should have no trouble getting your doors 
  254. entered. This is essentially just like you would write a regular Door batch 
  255. file.
  256.  
  257. Door Name for Menu: [Quizard's Mountain         ]
  258.  
  259. Description of Door: [Trivia and role playing all 'roled' into one!     ]
  260.  
  261. Path to this Door's Directory: [F:\DOORS\QM   <- Must exist. DoorBill checks!
  262.  
  263. Minimum Security to Access Door? [ 30]
  264.  
  265. Show Door to callers under level 30  [Y]  
  266.  
  267.  If you put Y this door will be shown to everyone, however those below
  268.  level 30 will NOT be allowed into this door. If you put N then it will
  269.  only be listed on the menu for level 30 and above.
  270.  
  271. Baud Rates Allowed     3[N]  12[Y]  24[Y]  48[Y]  96[N]  19.2[N]  38.4[N]
  272.  
  273.  In this example, anyone calling at baud rates of 300, 9600, 19200 and 38400 
  274.  would receive the message:
  275.        'This Door is not available at your current baud rate.'
  276.  and would be returned to the menu. The other baud rates would be allowed to
  277.  access the Door.
  278.  
  279. Command line 1: [HST   <- If you have an HST and have your Port locked, and
  280.   (optional)              this door doesn't run at the locked speed, by
  281.                           putting the HST command here, DoorBill will unlock
  282.         OR                the port and switch it to the callers connect rate.
  283.                           Make sure COMLOCK.EXE is in your DoorBill directory.
  284.  
  285. Command line  1: [QUIZRD31 QUIZARD.CFG                                   ]
  286.  .                              .                                        .
  287.  .                              .                                        .
  288. Command line 10: [                                                       ]
  289.  
  290. Conversion desired? (C/D/N/R/S): [D]
  291.  
  292. DoorBill will write a conversion file for the following formats:
  293.  
  294.      C = CALLINFO.BBS (Wildcat!)        D = DORINFO1.DEF (RBBS/QBBS/RA)
  295.      N = CHAIN.TXT (WWIV)               R = DOOR.SYS (GAP 52 Line)
  296.      S = SFDOORS.DAT (Spitfire)
  297.  
  298.  
  299.  
  300. DOORBILL v3.4 - Users Guide - Page 5
  301.  
  302.  
  303. If you wish to MOVE the Door to another Category, hit F4 and you will be
  304. shown a list of your active Categories and prompted for the number of the
  305. Category you wish to MOVE the Door to.
  306.  
  307. When the cursor is on one of the 10 Command Line fields, F1 and F2 become 
  308. active for inserting and deleting. You must hit F1 to save your data. Leaving 
  309. this screen via F9 or ESC will NOT save the data.
  310.  
  311. That's all there is to it! Just remember if you do enter the HST parameter, 
  312. it must be entered on Command Line 1.
  313.  
  314.  
  315.                                  Post Bulletin
  316.                                  -------------
  317.  
  318.   This option allows you to create a Bulletin file of all your Door
  319.   Categories and their associated Doors. Both ASCII and ANSI Bulletins
  320.   are created. The Bulletin will list all Categories and Doors so if you
  321.   have entries that you don't want everyone to see you will need to edit
  322.   those out of the Bulletin. The Bulletin is not created automatically.
  323.   You must select 'Post Bulletin' from DBUTIL's Main Menu. If you leave
  324.   the BLT Path field blank and select 'Post Bulletin', two files will be
  325.   created in the DoorBill directory with filenames of  'DOORBLT' and
  326.   'DOORBLTG'.
  327.  
  328.  
  329.                               Sort Door Listings
  330.                               ------------------
  331.  
  332.   This option sorts all Door listings in all Categories into alphabetical
  333.   order.
  334.  
  335.  
  336.  
  337. DOORBILL v3.4 - Users Guide - Page 6
  338.  
  339.  
  340.                                  DOORBILL.CFG
  341.                                  ------------
  342.  
  343. Configuration file when using USERS.SYS:
  344.    (Also accesses PCBOARD.SYS, PCBOARD.DAT, USERS, and CALLERx)
  345.    C:\PCB\USERS.SYS                    <- Path/filename to USERS.SYS
  346.    MicroNet PCBoard                    <- Name of BBS
  347.    Ted                                 <- Sysop's first name
  348.    Freeman                             <- Sysop's last Name
  349.  
  350. Configuration file when using PCBOARD.SYS:
  351.    (Also accesses PCBOARD.DAT, USERS, and CALLERx)
  352.    C:\PCB\PCBOARD.SYS                  <- Path/filename to PCBOARD.SYS
  353.    MicroNet PCBoard                    <- Name of BBS
  354.    Ted                                 <- Sysop's first name
  355.    Freeman                             <- Sysop's last Name
  356.  
  357. Configuration file when using DOOR.SYS:
  358.    C:\PCB\DOOR.SYS                     <- Path/filename to DOOR.SYS
  359.    MicroNet PCBoard                    <- Name of BBS
  360.    Ted                                 <- Sysop's first name
  361.    Freeman                             <- Sysop's last Name
  362.  
  363. Configuration file when using DORINFO1.DEF:
  364.    C:\BBS\DORINFO1.DEF                 <- Path/filename to DORINFO1.DEF
  365.                                           where 'x' is the Node number.
  366.    MicroNet PCBoard                    <- Name of BBS
  367.    Ted                                 <- Sysop's first name
  368.    Freeman                             <- Sysop's last Name
  369.  
  370. Configuration file when using CALLINFO.BBS:
  371.    C:\BBS\CALLINFO.BBS                 <- Path/filename to CALLINFO.BBS
  372.    MicroNet PCBoard                    <- Name of BBS
  373.    Ted                                 <- Sysop's first name
  374.    Freeman                             <- Sysop's last Name
  375.  
  376. Configuration file when using SFDOORS.DAT:
  377.    C:\BBS\SFDOORS.DAT                  <- Path/filename to SFDOORS.DAT
  378.    MicroNet PCBoard                    <- Name of BBS
  379.    Ted                                 <- Sysop's first name
  380.    Freeman                             <- Sysop's last Name
  381.  
  382. Configuration file when using CHAIN.TXT:
  383.    C:\BBS\CHAIN.TXT                    <- Path/filename to CHAIN.TXT
  384.    MicroNet PCBoard                    <- Name of BBS
  385.    Ted                                 <- Sysop's first name
  386.    Freeman                             <- Sysop's last Name
  387.  
  388. Configuration file when using GTUSER.BBS:
  389.    C:\BBS\GTUSER.BBS                   <- Path/filename to GTUSER.BBS
  390.    MicroNet PCBoard                    <- Name of BBS
  391.    Ted                                 <- Sysop's first name
  392.    Freeman                             <- Sysop's last Name
  393.    1                                   <- COM port number
  394.  
  395.  
  396.  
  397. DOORBILL v3.4 - Users Guide - Page 7
  398.  
  399.                               DOORBILL BATCH FILE
  400.                               -------------------
  401.  
  402. This is the batch file whose name is entered in PCBSETUP or the corresponding
  403. utility for your BBS. It should reside in your default BBS directory. Leave 
  404. this AS IS except for changing the paths. The 'x' in each line should be
  405. replaced with the NODE number (single node systems use 1).
  406.  
  407. ECHO OFF
  408. :START
  409. C:
  410. CD\PCB\DOORBILL                         
  411. IF EXIST DBRUNx.BAT DEL DBRUNx.BAT
  412. IF EXIST ENDBILL.x DEL ENDBILL.x
  413. DOORBILL DOORBILL.CFG
  414. IF EXIST ENDBILL.x GOTO EXIT
  415. IF NOT EXIST DBRUNx.BAT GOTO EXIT
  416. CALL BILLRUN
  417. GOTO START
  418. :EXIT
  419. C:
  420. CD\PCB
  421. BOARD
  422.  
  423.    NOTE: DoorBill requires the presence of BRUN45.EXE either in the
  424.          same directory as DoorBill or accessible via PATH. 
  425.  
  426.  
  427.                      ------------------------------------
  428.  
  429.  
  430.                                 DOOR OPERATION
  431.                                 --------------
  432.   
  433.   F3    -   Toggles the printer On/Off. Value is passed to PCBoard.
  434.   F4    -   Toggles the Page Bell On/Off. Value is passed to PCBoard.
  435.   F5    -   DOS Shell.  Allows SysOp to exit to DOS from inside a DOOR.
  436.   F7    -   Toggles the Caller Alarm On/Off. Value is passed to PCBoard.
  437.   F8    -   Returns the caller involuntarily to the BBS.
  438.   F9    -   Toggles the local display On/Off. Value is passed to PCBoard.
  439.   F10   -   Activates SysOp CHAT mode within the DOOR.
  440.   ESC   -   Deactivates CHAT mode.  DOOR is resumed.
  441.   HOME  -   HELP key for status line options.
  442.   UP    -   Allows the SysOp to give the caller extra time while in the DOOR.
  443.   DN    -   Allows the SysOp to subtract time from the caller.
  444.  
  445.       NOTE: Time and Level changes are passed to the BBS when using USERS.SYS,
  446.             SFDOORS.DAT, CALLINFO.BBS or DOOR.SYS.
  447.  
  448.   ALT-N -   SysOp next on toggle. (available only with USERS.SYS or 
  449.             PCBOARD.SYS). Value is passed to PCBoard.
  450.   ALT-X -   Exit to DOS after current caller logs off. (Available only
  451.             with USERS.SYS or PCBOARD.SYS). Value is passed to PCBoard.
  452.  
  453.  
  454. DOORBILL v3.4 - Users Guide - Page 8
  455.  
  456.                               MISCELLANEOUS NOTES
  457.                               -------------------
  458.  
  459.  
  460.       * The Printer, Page Bell, and Call Alarm toggles as well as any
  461.         changes in caller's Time or Level are written to DOOR.SYS,
  462.         CALLINFO.BBS and SFDOORS.DAT.
  463.  
  464.       * PCBoard's Call Waiting screen is only updated when using the
  465.         USERS.SYS file and not when using PCBOARD.SYS.
  466.  
  467.       * DoorBill creates it's own time keeping file called DBILLx.TIM.
  468.         If for some reason this doesn't get deleted, it could cause problems
  469.         for the next caller (like a Time Expired message!). To prevent this
  470.         simply add the following in the batch file that runs the BBS (NOT
  471.         DOORBILL'S BATCH FILE!). For PCBoard this is usually BOARD.BAT.
  472.  
  473.         IF EXIST C:\DOORBILL\DBILLx.TIM DEL C:\DOORBILL\DBILLx.TIM
  474.  
  475.         Of course you would substitute your own path to the DoorBill dir.
  476.         Substitute the Node number for the x.
  477.  
  478.       * GT Sysops please note that the COM port number must be included
  479.         on line 5 of the configuration file! When assigning security levels
  480.         for the Categories and Doors, Doorbill assigns levels as follows:
  481.         (9 to 0) = (53 to 62)
  482.         (A to Z) = (27 to 52)
  483.         (a to z) = (1 to 26)
  484.  
  485.  
  486.  
  487.  
  488.          M I C R O N E T  D O O R   R E G I S T R A T I O N   F O R M 
  489.  
  490.  
  491.         TO:  MicroNet                                   Date___/___/___ 
  492.              P.O. Box 83401  
  493.              Oklahoma City, OK 73148
  494.  
  495.  
  496.             (Please use capitalization and punctuation where necessary.)
  497.  
  498.  
  499.       FROM:  SysOp Name: _______________________________________________ 
  500.  
  501.              BBS Name: _________________________________________________
  502.  
  503.              Address: __________________________________________________ 
  504.  
  505.              City: ______________________ State: __________ ZIP: _______ 
  506.  
  507.              Voice: (   ) _________________ BBS: (   ) _________________
  508.  
  509.              BBS Software: _____________________ BBS Hours: ____________
  510.  
  511.              Baud Rates:________________________ 
  512.  
  513.  
  514.       SOFTWARE                          VERSION                  PRICE 
  515.       --------                          -------                  -----
  516.  
  517.       DoorBill........................... 3.4 ................. $30.00 __
  518.       Quizard's Mountain................. 3.1 ................. $25.00 __
  519.       Eliminate ......................... 4.2 ................. $20.00 __
  520.       Total Recall....................... 3.2 ................. $20.00 __
  521.       4 Square .......................... 1.0 ................. $20.00 __
  522.       Peg Jump .......................... 1.0 ................. $20.00 __
  523.       (Current versions as of 02-21-91)
  524.                                                                  _____
  525.  
  526.       (OK residents add 7% tax)                                  _____
  527.  
  528.       (Foreign orders add $10.00 for shipping)                   _____
  529.  
  530.       Total                                                    $______ 
  531.  
  532.  
  533.                                 F E E D B A C K 
  534.                                 ---------------
  535.  
  536.       I learned of DOORBILL from: 
  537.                 [  ] - A Friend         [  ] - Computer Club
  538.                 [  ] - BBS              [  ] - Compuserve
  539.                 [  ] - GEnie            [  ] - Other 
  540.  
  541.       COMMENTS: _____________________________________________________ 
  542.       _______________________________________________________________ 
  543.       _______________________________________________________________ 
  544.       _______________________________________________________________ 
  545.       _______________________________________________________________ 
  546.       _______________________________________________________________ 
  547.       _______________________________________________________________ 
  548.       _______________________________________________________________ 
  549.  
  550.  
  551.